현금영수증을 발급한 결제가 취소됐을 때 <a href="/reference#v1cash-receiptsreceiptkeycancelpost-receiptkey"><code>receiptKey</code></a>를 이용해서 현금영수증 발급을 취소합니다.
<a href="/reference#%ED%98%84%EA%B8%88%EC%98%81%EC%88%98%EC%A6%9D-%EB%B0%9C%EA%B8%89">현금영수증 발급 API</a>의 응답으로 받았던 <a href="/reference#cashreceiptresultdto-receiptkey"><code>CashReceipt.receiptKey</code></a>를 저장해 두었다가 Path 파라미터로 추가하세요.
부분 취소를 하려면 <a href="/reference#v1cash-receiptsreceiptkeycancelpost-amount"><code>amount</code></a> 값에 취소된 금액을 입력해서 사용합니다. <a href="/reference#v1cash-receiptsreceiptkeycancelpost-amount"><code>amount</code></a> 값이 없으면 전액 취소됩니다.

현금영수증 발급 취소 요청

receiptKey

취소할 금액, null이면 전액 발급 취소

총 거래금액

현금영수증 발급번호

승인시각

사업자번호

현금영수증 취소시간

핸드폰번호거나 주민번호거나 사업자번호

현금 거래 당사자 identify

국세청 에러

발급번호

대기 IN_PROGRESS, 국세청 요청 SENT, 국세청 승인 COMPLETED, 국세청 거절 FAILED

발급상태

결제시 넘긴 orderId 또는 발급요청시 넘긴 orderId

주문번호

거래 물품명

영수증 키

영수증 링크 url

요청시각, 나중에 조회할 때 사용됨

요청시간

면세금액

거래 종류

현금영수증 종류

현금영수증 최신 정보 리스트

결제 승인

paymentKey로 결제 조회

orderId로 결제 조회

결제 취소

가상계좌 발급 요청

authKey로 카드 빌링키 발급

카드 자동결제 승인

거래 조회

정산 조회

수동 정산 요청

현금영수증 발급 요청

현금영수증 조회

전체 프로모션 조회

카드 프로모션 조회

<a href="/sdk/payment-js#requestbillingauth%EC%B9%B4%EB%93%9C-%EA%B2%B0%EC%A0%9C-%EC%A0%95%EB%B3%B4">requestBillingAuth</a> 호출 후 <a href="/guides/v2/billing/integration#2-%EB%A6%AC%EB%8B%A4%EC%9D%B4%EB%A0%89%ED%8A%B8-url%EB%A1%9C-%EC%9D%B4%EB%8F%99%ED%95%98%EA%B8%B0">쿼리 파라미터로</a> 돌아오는 <a href="/reference#v1billingauthorizationsissuepost-authkey"><code>authKey</code></a>, 구매자 ID인 <a href="/reference#v1billingauthorizationsissuepost-customerkey"><code>customerKey</code></a>로 빌링키 발급을 요청합니다.

 자동결제 등록창 호출이 성공하면 리다이렉트 URL에 쿼리 파라미터(Query Parameter)로 돌아오는 일회성 인증 키입니다. 최대 길이는 300자입니다.


authKey

구매자 ID입니다. 빌링키와 연결됩니다. 다른 사용자가 이 값을 알게 되면 악의적으로 사용될 수 있습니다. 자동 증가하는 숫자 또는 이메일・전화번호・사용자 아이디와 같이 유추가 가능한 값은 안전하지 않습니다. 
<a href="/resources/glossary/uuid">UUID</a>
와 같이 충분히 무작위적인 고유 값으로 생성해주세요. 영문 대소문자, 숫자, 특수문자 
<code>-</code>
, 
<code>_</code>
, 
<code>=</code>
, 
<code>.</code>
, 
<code>@ </code>
를 최소 1개 이상 포함한 최소 2자 이상 최대 300자 이하의 문자열이어야 합니다.

customerKey

* 자동결제 API는 추가 계약 후 사용할 수 있습니다. 추가 계약을 하고 싶다면 토스페이먼츠 고객센터(1544-7772, support@tosspayments.com)로 문의해주세요.
발급받은 <a href="/reference#v1billingbillingkeypost-billingkey"><code>billingKey</code></a>로 카드 자동결제를 승인합니다. 카드 자동결제 승인은 최대 30초가 소요됩니다. 타임아웃 값을 최소 30초로 설정하세요.

 발급된 빌링키 정보입니다. 구매자의 결제 정보로 사용됩니다.


billingKey

amount

주문번호입니다. 주문한 결제를 식별합니다. 충분히 무작위한 값을 생성해서 각 주문마다 고유한 값을 넣어주세요. 영문 대소문자, 숫자, 특수문자 
<code>-</code>
, 
<code>_</code>
로 이루어진 6자 이상 64자 이하의 문자열이어야 합니다. 결제 데이터 관리를 위해 반드시 저장해야 합니다.

orderId

구매상품입니다. 예를 들면 
<code>생수 외 1건</code>
 같은 형식입니다. 최대 길이는 100자입니다.

orderName

구매자의 이메일 주소입니다. 결제 상태가 바뀌면 이메일 주소로 
<a href="/guides/v2/learn/payment-results#%EC%9D%B4%EB%A9%94%EC%9D%BC">결제내역</a>
이 전송됩니다. 최대 길이는 100자입니다.

customerEmail

 구매자명입니다. 최대 길이는 100자입니다.


customerName

면세 금액입니다. 값을 넣지 않으면 기본값인 
<code>0</code>
으로 설정됩니다.

taxFreeAmount

 과세를 제외한 결제 금액(컵 보증금 등)입니다.


taxExemptionAmount

특정 기간 동안 발급된 <a href="/resources/glossary/cash-receipt">현금영수증</a>을 조회합니다.
* 현금영수증 조회 API는 버전 2022-07-27 이상에서만 지원합니다. API 버전은 <a href="https://developers.tosspayments.com/my/api-keys">개발자센터</a>에서 확인·변경할 수 있습니다.
* 라이브 환경에서 비정상적으로 많은 요청을 보내면 <code>429 Too Many Requests</code> 상태 코드가 내려올 수 있습니다.

현금영수증 발급이 요청된 날짜로 조회하고 싶을 때 사용합니다. 
<code>yyyy-MM-dd</code>
 ISO 8601 형식입니다. (e.g. 
<code>2022-01-01</code>
)

requestDate

특정 현금영수증 발급 건 이후의 기록을 조회할 때 사용합니다. 이전 조회에서 돌아온 
<code>lastCursor</code>
 값을 전달합니다. 많은 양의 기록을 페이지 단위로 나누어 처리할 때 사용할 수 있습니다.

cursor

한 번에 응답받을 기록의 개수입니다. 기본값은 
<code>100</code>
이고 설정할 수 있는 최대값은 
<code>10000</code>
입니다.

limit

<a href="/resources/glossary/cash-receipt">현금영수증</a> 발급을 요청합니다. 현금영수증을 발급할 때는 현금영수증 발급 용도와 현금영수증 발급에 필요한 소비자 인증수단 정보가 반드시 필요합니다. 현금영수증 발급 용도를 <a href="/reference#v1cash-receiptspost-type"><code>type</code></a>에, 소비자 인증수단은 <a href="/reference#v1cash-receiptspost-customeridentitynumber"><code>customerIdentityNumber</code></a>에 추가해주세요.

 현금영수증을 발급할 금액입니다.


현금영수증의 종류입니다. 
<code>소득공제</code>
, 
<code>지출증빙</code>
 중 하나입니다. 소득 공제용 현금영수증을 발급받을 때는 소비자 인증수단으로 휴대폰 번호나 현금영수증 카드 번호가 필요하고, 지출 증빙용 현금영수증을 발급받을 때는 사업자 등록번호를 입력해야 합니다.

type

 현금영수증 발급에 필요한 소비자 인증수단입니다. 현금영수증을 발급한 주체를 식별합니다. 최대 길이는 30자입니다. 현금영수증 종류에 따라 휴대폰 번호, 사업자등록번호, 현금영수증 카드 번호 등을 입력할 수 있습니다.


customerIdentityNumber

registrationNumber

면세 금액입니다. 값을 넣지 않으면 기본값인 
<code>0</code>
으로 설정됩니다. 하나의 결제에 과세 상품과 면세 상품이 섞여있다면 이 파라미터로 면세 상품 금액을 보내주세요. 보낸 금액 만큼 현금영수증이 발급됩니다.

 현금영수증의 키값입니다. 최대 길이는 200자입니다.


 현금영수증 발급을 취소할 금액입니다. 값이 따로 없으면 전액 취소됩니다.


<a href="/reference#v1paymentsconfirmpost-paymentkey"><code>paymentKey</code></a>에 해당하는 결제를 검증하고 승인합니다.
<a href="/guides/v2/get-started/payment-flow#%EC%9A%94%EC%B2%AD-%EC%9D%B8%EC%A6%9D-%EC%8A%B9%EC%9D%B8">결제 인증</a>이 유효한 10분 안에 상점에서 결제 승인 API를 호출하지 않으면 해당 결제는 <a href="/reference/using-api/webhook-events#payment_status_changed">만료됩니다</a>.

 결제의 키값입니다. 최대 길이는 200자입니다. 결제를 식별하는 역할로, 중복되지 않는 고유한 값입니다.


paymentKey

승인된 결제를 <a href="/reference#v1paymentsordersorderidget-orderid"><code>orderId</code></a>로 조회합니다. <a href="/reference#v1paymentsordersorderidget-orderid"><code>orderId</code></a>는 SDK로 <a href="/guides/v2/get-started/payment-flow#%EC%9A%94%EC%B2%AD-%EC%9D%B8%EC%A6%9D-%EC%8A%B9%EC%9D%B8">결제를 요청</a>할 때 직접 생성한 값입니다.

승인된 결제를 <a href="/reference#v1paymentspaymentkeyget-paymentkey"><code>paymentKey</code></a>로 조회합니다. <a href="/reference#v1paymentspaymentkeyget-paymentkey"><code>paymentKey</code></a>는 SDK를 사용해 결제할 때 발급되는 고유한 키값으로 결제가 최종 승인된 후 돌아오는 <a href="#payment-%EA%B0%9D%EC%B2%B4">Payment 객체</a>에 담겨있습니다.

승인된 결제를 <a href="/reference#v1paymentspaymentkeycancelpost-paymentkey"><code>paymentKey</code></a>로 취소합니다. 취소 이유를 <a href="/reference#v1paymentspaymentkeycancelpost-cancelreason"><code>cancelReason</code></a>에 추가해야 합니다.
결제 금액의 일부만 부분 취소하려면 <a href="/reference#v1paymentspaymentkeycancelpost-cancelamount"><code>cancelAmount</code></a>에 취소할 금액을 추가해서 API를 요청합니다. <a href="/reference#v1paymentspaymentkeycancelpost-cancelamount"><code>cancelAmount</code></a>에 값을 넣지 않으면 전액 취소됩니다.
* <a href="/reference/using-api/authorization#%EB%A9%B1%EB%93%B1%ED%82%A4-%ED%97%A4%EB%8D%94">멱등키</a>를 요청 헤더에 추가하면 중복 취소 없이 안전하게 처리됩니다.

 결제를 취소하는 이유입니다. 최대 길이는 200자입니다.


cancelReason

 취소할 금액입니다. 값이 없으면 전액 취소됩니다.


cancelAmount

결제 취소 후 금액이 환불될 계좌의 정보입니다. 
<a href="/resources/glossary/virtual-account">가상계좌</a> 결제에만 필수입니다.
 다른 결제수단으로 이루어진 결제를 취소할 때는 사용하지 않습니다. 보낸 계좌 정보는 유효성 검사가 이뤄집니다. 유효한 계좌로 결제 취소 요청이 되었다면 환불은 취소 요청 후 2일 후에 진행됩니다. 구매자가 가상계좌에 입금을 아직 안 했다면, 결제를 취소해도 환불해야 되는 금액이 없기 때문에 이 파라미터를 추가할 필요가 없습니다. 입금 전에는 부분 취소를 할 수 없고 전체 금액 취소만 할 수 있습니다.

refundReceiveAccount

취소할 금액 중 면세 금액입니다. 값을 넣지 않으면 기본값인 
<code>0</code>
으로 설정됩니다.

취소 통화입니다. 승인된 통화와 동일한 값을 사용해야 합니다. 일반결제는 
<code>KRW</code>
, 
<code>USD</code>
, 
<code>JPY</code>
를 지원합니다. 해외 간편결제(PayPal)는 
<code>USD</code>
만 지원합니다.

currency

 현재 환불 가능한 금액입니다. 결제 취소를 안전하게 처리합니다.


refundableAmount

전체 프로모션 정보를 조회합니다.

카드사별 혜택을 조회합니다. 즉시 할인, 무이자 정보가 내려갑니다.

지정한 날짜 정보로 <a href="/resources/glossary/settlement">정산</a> 기록을 조회합니다.
정산 기록은 결제가 일어난 다음 날부터 조회됩니다. 따라서 만약 오늘이 1월 11일이라면, 1월 11일 결제의 정산 기록은 다음 날인 1월 12일에 <a href="/reference#v1settlementsget-startdate"><code>startDate</code></a>를 <code>2024-01-11</code>로, <a href="/reference#v1settlementsget-enddate"><code>endDate</code></a>를 <code>2024-01-12</code>로 요청해서 확인할 수 있습니다.
많은 양의 정산 기록을 조회한다면 <a href="/reference#v1settlementsget-page"><code>page</code></a>와 <a href="/reference#v1settlementsget-size"><code>size</code></a> 파라미터를 사용해서 페이지 단위로 기록을 나누어 조회할 수 있습니다. 예를 들어 <a href="/reference#v1settlementsget-page"><code>page</code></a>를 3으로, <a href="/reference#v1settlementsget-size"><code>size</code></a>를 100으로 설정한다면 설정한 기간 동안의 전체 기록을 100개씩 나누어 보여주고, 전체 페이지 중 3페이지의 기록을 조회합니다.
* 정산 조회는 최대 60초가 소요됩니다. 타임아웃 값을 최소 60초로 설정하세요. 라이브 환경에서 비정상적으로 많은 요청을 보내면 <code>429 Too Many Requests</code> 상태 코드가 내려올 수 있습니다.

조회를 시작하고 싶은 날짜 정보입니다. 
<code>yyyy-MM-dd</code>
 ISO 8601 형식입니다.

startDate

조회를 마치고 싶은 날짜 정보입니다. 
<code>yyyy-MM-dd</code>
 ISO 8601 형식입니다.

endDate

조회 기준이 되는 날짜 타입입니다. 
<code>soldDate</code>
(정산 매출일)나 
<code>paidOutDate</code>
(정산 지급일) 중 하나입니다.

dateType

조회할 페이지 값입니다. 최소값은 
<code>1</code>
입니다. 많은 양의 정산 기록을 조회할 때 
<code>size</code>
 파라미터와 함께 사용합니다.

page

한 페이지에서 응답으로 보여줄 정산 기록 개수를 의미합니다. 기본값은 
<code>100</code>
이고 설정할 수 있는 최대값은 
<code>5000</code>
입니다. 많은 양의 정산 기록을 조회할 때 
<code>page</code>
 파라미터와 함께 사용합니다.

size

<a href="/resources/glossary/manual-settlement">수동 정산</a>은 일정 기간 동안 쌓인 카드 결제 기록 중에 한 건만 선택해서 정산 받는 방법입니다.
* 수동 정산 요청 API는 추가 계약 후 사용할 수 있습니다. 추가 계약을 하고 싶다면 토스페이먼츠 고객센터(1544-7772, support@tosspayments.com)로 문의해주세요.
매입하고 싶은 결제 건을 <a href="/reference#v1settlementspost-paymentkey"><code>paymentKey</code></a>로 특정해서 카드사에 정산을 요청합니다.

 수동 정산을 요청할 결제 건을 특정하는 키값 입니다. 최대 길이는 200자입니다.


특정 기간의 거래 기록을 조회합니다. 거래 기록은 거래가 처리된 시점(<a href="/reference#paymenttransactiondto-transactionat"><code>transactionAt</code></a>)을 기준으로 조회합니다.
Query 파라미터 <a href="/reference#v1transactionsget-startdate"><code>startDate</code></a>와 <a href="/reference#v1transactionsget-enddate"><code>endDate</code></a>로 지정한 날짜 정보를 사용합니다. 거래가 일어난 당일부터 거래 기록을 조회할 수 있습니다. 예를 들어 예제의 요청은 2022년 1월 1일부터 1월 2일까지 일어난 거래를 조회합니다.
* 거래 조회는 최대 60초가 소요됩니다. 타임아웃 값을 최소 60초로 설정하세요. 라이브 환경에서 비정상적으로 많은 요청을 보내면 <code>429 Too Many Requests</code> 상태 코드가 내려올 수 있습니다.

조회를 시작하고 싶은 날짜와 시간 정보입니다. 
<code>yyyy-MM-dd'T'hh:mm:ss</code>
 ISO 8601 형식입니다.

조회를 마치고 싶은 날짜와 시간 정보입니다. 
<code>yyyy-MM-dd'T'hh:mm:ss</code>
 ISO 8601 형식입니다.

특정 결제 건 이후의 기록을 조회할 때 사용합니다. 
<a href="/reference#paymenttransactiondto-transactionkey"><code>transactionKey</code></a>
 값을 전달합니다. 많은 양의 기록을 페이지 단위로 나누어 처리할 때 사용할 수 있습니다.

startingAfter

한 번에 응답받을 기록의 개수입니다. 기본값은 
<code>100</code>
이고 설정할 수 있는 최대값은 
<code>5000</code>
입니다.

구매자가 원하는 은행의 <a href="/resources/glossary/virtual-account">가상계좌</a> 발급을 요청합니다.

구매상품입니다. 예를 들면 
<code>생수 외 1건</code>
 같은 형식입니다. 최대 길이는 100자입니다.
최소 1글자 이상 100글자 이하여야 합니다.

 입금할 구매자명입니다. 최대 길이는 100자입니다.


가상계좌를 발급할 은행입니다. 가상계좌 발급이 가능한 
<a href="/codes/org-codes#%EC%9D%80%ED%96%89-%EC%BD%94%EB%93%9C">은행</a>
을 참고하세요.

bank

가상계좌 발급 시점으로부터 가상계좌가 유효한 시간입니다. 설정한 
<code>validHours</code>
 안에 구매자가 입금을 하지 않으면 주문은 취소됩니다. 설정할 수 있는 최대값은 
<code>2160</code>
시간(90일)입니다.

validHours

가상계좌 입금 기한입니다. 
<code>dueDate</code>
이 지난 시점에 입금을 시도하면 실패합니다. 티켓 예매 등 주문 시간과 상관없이 정해진 시점까지 결제를 받아야 할 때도 사용할 수 있습니다. 설정할 수 있는 최대값은 결제 요청일로부터 90일입니다. 
<code>yyyy-MM-dd'T'HH:mm:ss</code>
 ISO 8601 형식을 사용합니다.

dueDate

구매자의 휴대폰 번호입니다. 가상계좌 입금 안내가 전송되는 번호입니다. 
<code>-</code>
 없이 숫자로만 구성된 최소 8자, 최대 15자의 문자열입니다.

customerMobilePhone

<a href="/resources/glossary/escrow">에스크로</a>
 사용 여부입니다. 값을 넣지 않으면 기본값인 
<code>false</code>
로 설정되고 사용자가 에스크로 결제 여부를 선택합니다.

useEscrow

 현금영수증 발급 정보를 담는 객체입니다.


cashReceipt

 각 상품의 상세 정보를 담는 배열입니다.
예를 들어 사용자가 세 가지 종류의 상품을 구매했다면 길이가 3인 배열이어야 합니다. 에스크로 결제를 사용할 때만 필요한 파라미터입니다.


escrowProducts

셀러에게 지급할 수 있는 정산 금액을 조회합니다.

잔액 조회

지급 요청 목록을 조회합니다.
* 라이브 환경에서 비정상적으로 많은 요청을 보내면 <code>429 Too Many Requests</code> 상태 코드가 내려올 수 있습니다.

조회하고 싶은 지급대행 요청건의 개수입니다. 기본 값은 
<code>10</code>
이고, 설정할 수 있는 최대값은 
<code>10000</code>
입니다.

커서로 사용할 지급대행 요청건의 
<code>id</code>
입니다. 설정한 
<code>id</code>
의 지급대행 요청건 다음으로 등록된 요청건부터 조회됩니다. 설정하지 않으면 최초의 지급대행 요청건부터 조회됩니다.

 커서로 사용할 지급일입니다. 해당 지급일과 같거나 더 이후(이상)에 발생하는 지급대행 요청 건을 조회합니다.


payoutDateGte

 지급일입니다. 해당 지급일과 같거나 더 이전(이하)에 발생하는 지급대행 요청 건을 조회합니다.


payoutDateLte

지급 요청 목록 조회

지급 대상 셀러에게 정산 금액을 이체합니다. 요청 시점에 잔액이 부족하면 지급이 실패합니다.
지급대행 요청은 지급대행 서비스의 POST 요청입니다. <a href="/guides/v2/payouts#encryption-%EB%B3%B4%EC%95%88"><code>ENCRYPTION</code> 보안</a>으로 요청을 보내주세요.
최대 100건의 지급대행을 한 번에 요청할 수 있습니다. 하지만 하나의 요청이 실패하면 요청 모두 실패하고 첫 번째 실패 건에 대한 에러 객체가 응답으로 돌아옵니다. 1건의 지급대행 요청에는 10억 미만의 정산 금액을 이체할 수 있습니다.
지급대행으로 셀러에게 지급한 정산 금액은 회수하기 어렵습니다. 토스페이먼츠는 지급 관련 책임이 없기 때문에 지급대행 서비스를 신중하게 사용해주세요.
<div>* 지급대행 요청 API를 라이브 환경에서 테스트하면 수수료가 부과됩니다.</div>

 상점에서 직접 발급하는 지급대행 식별자입니다. 각 지급대행 요청 건에 고유 값을 발급해야 되고 지급대행 상점에서 참고용으로 사용할 수 있습니다.


refPayoutId

정산금을 지급받는 셀러입니다. 
<a href="#seller-%EA%B0%9D%EC%B2%B4">Seller 객체</a>
의 
<code>id</code>
 값입니다.

destination

 지급대행의 유형입니다. 아래 둘 중 하나입니다.


scheduleType

<code>yyyy-MM-dd</code>
 형식의 지급일입니다. 지급대행 유형이 
<code>SCHEDULED</code>
일 때는 필수입니다. 지급일은 미래에 1년 이내에 있는 영업일로만 설정할 수 있어요. 휴일, 공휴일, 과거일자로 설정하면 오류가 발생해요.

payoutDate

 이체 내역에 표시되는 적요입니다. 최대 길이는 7자입니다.


transactionDescription

요청과 관련된 추가 정보를 key-value 쌍으로 담고 있는 객체입니다. 최대 5개의 키-값(key-value) 쌍입니다. 키는 
<code>[</code>
 , 
<code>]</code>
 를 사용하지 않는 최대 40자의 문자열, 값은 최대 500자의 문자열입니다.

metadata

지급대행 요청

지급 요청 한 건을 조회합니다.

조회하고 싶은 Payout 객체의 
<code>id</code>
입니다.

지급 요청 단건 조회

<code>REQUESTED</code> 상태의 지급대행 요청 건을 취소합니다. 이미 처리 중이거나 완료된 지급대행 요청 건은 취소할 수 없습니다.

취소하고 싶은 Payout 객체의 
<code>id</code>
입니다.

지급대행 요청 취소

토스페이먼츠에 등록한 셀러 목록을 조회합니다. 삭제되지 않은 셀러만 조회할 수 있어요.
* 라이브 환경에서 비정상적으로 많은 요청을 보내면 <code>429 Too Many Requests</code> 상태 코드가 내려올 수 있습니다.

조회하고 싶은 셀러 개수입니다. 기본 값은 
<code>10</code>
입니다. 설정할 수 있는 최대값은 
<code>10000</code>
입니다.

특정 셀러의 
<code>id</code>
입니다. 해당 
<code>id</code>
의 셀러 다음으로 등록된 셀러부터 조회됩니다. 기본 값은 최초에 등록된 셀러입니다.

셀러 목록 조회

오픈마켓에 입점해있는 셀러의 정보를 토스페이먼츠에 등록합니다. 셀러의 사업자번호, 계좌 유효성를 검증합니다.
셀러 등록은 지급대행 서비스의 POST 요청입니다. <a href="/guides/v2/payouts#encryption-%EB%B3%B4%EC%95%88"><code>ENCRYPTION</code> 보안</a>으로 요청을 보내주세요.

오픈마켓 상점에서 발급하는 셀러의 고유 식별자입니다. 연동 중에 참고할 수 있는 값입니다. 등록 이후에 수정할 수 없고, 삭제된 셀러의 
<code>refSellerId</code>
는 다시 사용할 수 없습니다. 허용된 길이는 7-20자 입니다.

refSellerId

사업자 유형입니다. 
<code>INDIVIDUAL</code>
(개인), 
<code>INDIVIDUAL_BUSINESS</code>
(개인사업자), 
<code>CORPORATE</code>
(법인사업자) 중 하나입니다.

businessType

법인사업자 또는 개인사업자 셀러 정보입니다. 
<code>businessType</code>
이 
<code>INDIVIDUAL_BUSINESS</code>
 또는 
<code>CORPORATE</code>
이면 필수입니다.

company

개인 셀러 정보입니다. 
<code>businessType</code>
이 
<code>INDIVIDUAL</code>
이면 필수입니다.

individual

 셀러가 정산 금액을 지급받을 계좌 정보입니다.


account

셀러와 관련된 추가 정보를 key-value 쌍으로 담고 있는 JSON 객체입니다. 최대 5개의 키-값(key-value) 쌍입니다. 키는 
<code>[</code>
 , 
<code>]</code>
 를 사용하지 않는 최대 40자의 문자열, 값은 최대 500자의 문자열입니다.

셀러 등록

등록된 셀러를 삭제합니다. 삭제한 셀러의 <code>id</code> 식별자는 다시 발급되지 않고 조회가 불가능합니다.

삭제하고 싶은 Seller 객체의 
<code>id</code>
입니다. 토스페이먼츠에서 발급한 값이며, 오픈마켓 상점에서 발급한 
<code>refSellerId</code>
와 다른 값입니다.

셀러 삭제

토스페이먼츠에 등록한 하나의 셀러를 조회합니다. 삭제되지 않은 셀러만 조회할 수 있어요.

조회하고 싶은 Seller 객체의 
<code>id</code>
입니다. 토스페이먼츠에서 발급한 값이며, 오픈마켓 상점에서 발급한 
<code>refSellerId</code>
와 다른 값입니다.

셀러 단건 조회

등록된 셀러 정보를 수정합니다. 수정하고 싶은 필드만 Request Body 파라미터로 보내주세요. 파라미터를 보내지 않으면 정보가 바뀌지 않습니다. 데이터를 삭제하고 싶다면 파라미터의 값을 <code>null</code>로 보내주세요. 등록할 때 필수 값이었던 필드는 삭제할 수 없습니다.
셀러 수정은 지급대행 서비스의 POST 요청입니다. <a href="/guides/v2/payouts#encryption-%EB%B3%B4%EC%95%88"><code>ENCRYPTION</code> 보안</a>으로 요청을 보내주세요.

수정하고 싶은 Seller 객체의 
<code>id</code>
입니다. 토스페이먼츠에서 발급한 값이며, 오픈마켓 상점에서 발급한 
<code>refSellerId</code>
와 다른 값입니다.

 법인사업자 또는 개인사업자 셀러 정보입니다.


 셀러에서 정산 금액을 지급받을 계좌 정보입니다.


API 테스트

현금영수증 발급 취소 요청

POST

파라미터

Request Body 파라미터